home *** CD-ROM | disk | FTP | other *** search
/ Box' of X 3 / Box' of X 3.iso / x-viewer / unix / x11 / xv200.txt < prev    next >
Encoding:
Text File  |  1992-08-06  |  8.1 KB  |  182 lines
  1. Thanks for acquiring a copy of the XV distribution.  I hope you enjoy it.
  2.  
  3. If you like the program and decide to use it, *please* send me a short
  4. email message to that effect.  Be sure to mention the full name of your
  5. organization.  When our sponsors ask us 'what have you been doing', it 
  6. always looks good if we can come up with a nice long list of folks who are
  7. using code developed in the GRASP Lab.  Brownie points, y'see.
  8.  
  9. Also, if you find XV to be nifty, useful, generally 'cool', and of
  10. some value to you, your donation (not tax-deductable) would be greatly
  11. appreciated.  $10 (U.S.) is probably a fine amount to donate.
  12. Folks who donate $25 and up will receive a nice, bound copy of the XV Manual
  13. printed on a spiffo 600-dpi laser printer.  It'll look lovely mounted over
  14. your fireplace.
  15.  
  16. Please send all donations (or other correspondence) to:
  17.     John Bradley
  18.     1053 Floyd Terrace
  19.     Bryn Mawr, PA  19010
  20.  
  21. U.S. Funds only, please.  Checks should be made payable to 'John Bradley'.
  22.  
  23.  
  24. Installation
  25. ------------
  26. If you don't plan to use Imake, copy 'Makefile.std' (a regular old-style
  27. minimalist makefile) to 'Makefile'.
  28.  
  29. If you are building the program on a Sun running SunOS, a DECstation running
  30. Ultrix, or an IBM RS/6000 running AIX, you should be able to just type 'make'
  31. and have everything compile cleanly.  (Possibly some warnings from the 
  32. optimizer on DECstations.)  Otherwise, particularly if you're running on a
  33. SVR4-based system, you'll probably have to edit the Makefile.
  34.  
  35. Check the Makefile for the configuration option(s).  There are unfortunately
  36. quite a few these days, to support a number of different machines.  If
  37. you're on a SVR4-based machine, you'll probably need '-DSVR4' and '-DDIRENT'.
  38. Read the file for more specific info.
  39.  
  40. Otherwise, check the options in the Imakefile, and generate a Makefile
  41. using 'xmkmf' (or whatever).  Be sure to 'make depend' before building
  42. the program.
  43.  
  44. Important Note: The contents of the 'jpeg' directory are the latest
  45. version of the free JPEG software provided by the Independent JPEG
  46. Group.  In order to remain fully compatible with future releases (so I
  47. can just 'drop in' new releases of the JPEG software as they become
  48. available), I have not modified this source in any way, including the
  49. makefile.  The practical upshot is that the JPEG software isn't as
  50. integrated into the XV Makefile/Imakefile as you might like it to be.
  51. Regardless of whether you use the Makefile or the Imakefile in the xv
  52. directory, YOU MAY HAVE TO EDIT THE MAKEFILE IN THE JPEG SUBDIRECTORY.
  53. In particular, you must make sure that you use the same compiler for
  54. the JPEG library as you use for the rest of XV.  If you decide to
  55. compile xv with 'gcc', be CERTAIN you modify the makefile in the jpeg
  56. subdirectory so that it also will be compiled with gcc.
  57.  
  58. Once you've built the program succesfully, copy the programs 'xv' and 
  59. 'bggen' to wherever you like your binaries to live, and copy the files
  60. 'docs/xv.man' and 'docs/bggen.man' to the approprate man-page directory.
  61. Don't forget to change the suffixes appropriately.
  62.  
  63. Finally, print out a copy of docs/xvdocs.ps on a PostScript printer.  If you
  64. are unable to do so, and would like a printed copy of the manual, contact
  65. the author for details.
  66.  
  67. Note:  If you are using 'transcript 2.1' to drive your PostScript printer,
  68. you may run into a problem where the xvdocs.ps file prints in the wrong font
  69. (courier, or something, instead of helvetica).  This seems to be caused by
  70. 'psrv', which tries to reverse the pages of all PostScript files.  It fails
  71. on this PostScript file.  You (or the local system administrator) can 
  72. temporarily fix this by replacing the line:
  73.   'REVERSE = /pkg/lib/ps/psrv'
  74. with
  75.   'REVERSE = /bin/cat'
  76. in the file /pkg/lib/ps/psint.sh.
  77.  
  78.  
  79. Caveats
  80. -------
  81.  
  82. XV has been developed on a Sun 4/280 running SunOS 4.1, using both the normal
  83. 'cc' and gcc-1.37 compilers.  There shouldn't be anything grotesque enough
  84. in the code to break any other compilers.  
  85.  
  86. The viewing environment has mainly been an IBM RT with an 8-bit color
  87. display.  It has been tested with TWM, MWM, UWM, TVTWM, OLWM, and
  88. DXWM, in roughly that order of thoroughness.  (ie, I personally use
  89. TWM, and my primary tester uses MWM.)
  90.  
  91. I have personally compiled and tested it on the following systems: Sun
  92. 4 running SunOS 4.1, VAXstation 3500 running Ultrix 3.0, MicroVax II
  93. running Ultrix 2.0, DecStation 3100 running UWS 3.0, IBM RISC
  94. System/6000 running AIX 3.1.
  95.  
  96. It has displayed on the following systems:  IBM RT (8-bit color), Sun 3 
  97. (1-bit B/W), Sun 3 (8-bit grayscale), Sun 4 (1-bit B/W), MicroVax II (8-bit
  98. color), MicroVax II (4-bit grayscale), a variety of HPs (4-bit color, 6-bit 
  99. color, 8-bit color, and 24-bit color), and Visual, NCD, Tektronix, and
  100. HDS X terminals (1-bit B/W and 8-bit color).
  101.  
  102. 'vsprintf.c' has been included for the benefit of those on machines that
  103. don't have it.  (Basically, machines running 'vanilla' BSD 4.3)
  104.  
  105.  
  106. Bizarrities
  107. -----------
  108.  
  109. There are some known problems with running XV in conjunction with 'dxwm'.
  110. I'm hoping that that is now a defunct window manager, and that everybody who 
  111. was using that will switch to mwm.  Whether this hope is well-founded or not 
  112. is another matter entirely.  See the DXWM option in the Makefile/Imakefile.
  113.  
  114.  
  115. Problems with TWM and TVTWM
  116. ---------------------------
  117.  
  118. XV would appear to exercise a pair of bugs in the version of TWM in MIT's
  119. X11R4 Standard Distribution tape.  Perhaps they've been fixed by now.
  120.  
  121. Colormap Installation: under twm, if you have multiple XVs running,
  122. and each has their own colormap, sometimes the colormap doesn't get
  123. properly installed if you move the mouse directly from one XV to the
  124. other, quickly, so that it doesn't see the mouse go into the root
  125. window, or any other window.  If you move the mouse outside the window
  126. and move it back in, it SHOULD install the colormap correctly.
  127.  
  128. Colormap Installation: Note, if an alternate colormap is installed, it
  129. will ONLY be installed when the mouse is inside the IMAGE window.  It
  130. will not be installed when the mouse is in any other XV windows
  131. (except for the color editor window).  This is because I can't
  132. guarantee that the other windows will still have contrasting
  133. foreground/background colors when the alternate colormap is installed.
  134. It is assumed that if you put the mouse in a window, you will want to
  135. use that window, so you'd better be able to READ that window...
  136.  
  137. There's a bug in my version of TWM that creeps up if you have
  138. titlebars turned off.  Essentially, XV tells the window manager to
  139. make the window a certain size.  TWM (wrongly) adds enough room at the
  140. top to put its title bar there, but doesn't draw it, since titlebars
  141. are turned off.  XV gets back a ConfigureNotify event on the window
  142. with the new size, which is large by 20-odd pixels in height.  
  143.  
  144. There *used* to be a '-twmkludge' option in the previous version of xv
  145. to 'work around' this problem.  Unfortunately, this work around introduced
  146. more problems than it solved, and has since been removed.  The current
  147. thinking is:  if you're using TWM, you should probably be using titlebars.
  148. If you insist on not having titlebars, and your TWM doesn't behave properly,
  149. you should fix TWM.  (It's a one-line fix, and I'll gladly send it to anybody
  150. who asks for it.)
  151.  
  152.  
  153. Copyright Notice
  154. ----------------
  155. Copyright 1989, 1990, 1991, 1992 by John Bradley 
  156.               and the University of Pennsylvania
  157.  
  158. Permission to use, copy, and distribute for non-commercial purposes,
  159. is hereby granted without fee, providing that the above copyright
  160. notice appear in all copies and that both the copyright notice and this
  161. permission notice appear in supporting documentation. 
  162.  
  163. The software may be modified for your own purposes, but modified versions
  164. may not be distributed without prior consent of the the author.
  165.  
  166. This software is provided "as is" without any expressed or implied warranty.
  167.  
  168. The author may be contacted via:
  169.     US Mail:   John Bradley
  170.                GRASP Lab, Room 312C
  171.                3401 Walnut St.  
  172.                Philadelphia, PA  19104
  173.  
  174.     Phone:     (215) 898-8813
  175.     EMail:     bradley@cis.upenn.edu       
  176.  
  177.  
  178. If you'd like to do something with XV that the copyright prohibits (such
  179. as include it in a commercial product), please contact the author (preferably
  180. through email).  Arrangements can probably be worked out.
  181.  
  182.